home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 008 / qb_herc.arc / QB-UTILS.DOC next >
Encoding:
Text File  |  1987-02-09  |  4.6 KB  |  102 lines
  1. This software is distributed " as is " with no warranty or any responsibility
  2. on the part of the author for any loss or damages due to use ( or misuse ) of
  3. this software.  I reserve all rights to this software and have applied and
  4. received a copyright for this software.  You may freely use this software in
  5. any NON commercial usage for any non profit software package.  No fee, royalty, 
  6. or charge of any kind shall accompany the distribution of this software.  
  7. Including the profitable distribution of diskettes using this software to 
  8. enhance the value of the diskettes beyond their normal market value.  
  9. Any mail order disribution will be construed as using the mail to violate my 
  10. rights by distribiting my copyrighted work without my permission and would 
  11. result in filing of charges with the postmaster general for using the mail to
  12. illegally distribute copyrighted material.
  13.  
  14. If you wish to use these routines in any commercial venture you must first
  15. receive permission from the author who can be reached at
  16. (517) 351-4689. 
  17.  
  18.         QB-UTILS                        Copyright (c) 1986
  19.                                         Maverick Software
  20.                                         (517) 351-4689
  21. HMODE(a%)
  22.  
  23. The call HMODE expects one integer size parameter and functions accordingly.  
  24. The syntax being call hmode(a%)
  25.      1. If a%=0 then enter text mode
  26.      2. If a%=1 then enter graphics mode and clear graphics screen 
  27.         on entry to graphics mode
  28.      3. If a%=2 then enter graphics mode and don't clear graphics screen
  29.         on entry to graphics mode
  30.      4. If a%=3 then clear graphics screen but don't enter graphics mode
  31.      5. If a%=any other value then just enter graphics mode, don't clear
  32.         graphics screen on entry
  33.  
  34. HPOINT(x%,y%,kolor%)
  35.  
  36. The call hpoint expects 3 integer size parameters and functions accordingly.
  37. The syntax being call hpoint(x%,y%,kolor%)
  38.      1. x% is the x coordinate of the point from x%=0 to 719, 
  39.         not value checked.
  40.      2. y% is the y coordinate of the point from y%=0 to 347,
  41.         not value checked.
  42.      3. kolor%=0 to display a black dot ( erase a dot ) any other value
  43.         will display a white dot ( turn dot on )
  44.  
  45. HLINE(x1%,y1%,x2%,y2%,kolor%)
  46.  
  47. The call hline expects 5 integer size parameters and functions accordingly.
  48. The syntax being call hline(x1%,y1%,x2,y2,kolor%)
  49.      1. x1%,y1% being the starting coordinates using the same limits for
  50.         x% and y% as in the hpoint call ( not value checked )
  51.      2. x2%,y2% are the end coordinates using the same limits for x% and y%
  52.         again not value checked
  53.      3. If kolor%=0 then draw a black line ( turn off line ) any other value 
  54.         will draw a white ( visible ) line.
  55.  
  56. HPRINT(x%,y%,q%)
  57.  
  58. The call hprint expects 3 parameters and functions accordingly.
  59. The syntax being call hprint(a$,x%,y%,q%)
  60.      1. Where a$ is the string descriptor.  Only the lower 127 characters
  61.         are printed and all control characters are printed according to 
  62.         their ascii representation.
  63.      2. x%,y% are the starting x,y coordinates for the text.  The text is
  64.         pixel mapped so you can specify for the text to start at coordinates
  65.         ranging from x%=0 to 719 and y%= 0 to 347 ( not value checked )
  66.      3. The integer q% can have several values.  
  67.           a. If q%=0 then the leftmost character of the string will 
  68.              start at the given x%,y% coordinates.  This is left justified.
  69.           b. If q%=1 then the text will be centered about the given x%,y%
  70.              coordinate pair.
  71.           c. If q%=2 the text will be right justified using the x%,y% pair
  72.              as the rightmost margin. This is right justified, jagged left
  73.              margin.
  74.        d. Any other value of q% is treated as right justified as explained
  75.              above
  76.  
  77. HGET(x%,y%,kolor%)
  78.  
  79. The call hget expects 3 integer size parameters and functions accordingly.
  80. The syntax being call hget(x%,y%,kolor%)
  81.      1. The parameters x%,y% specify the x,y coordinates of the point in 
  82.         question.  If the point is off then the routine returns a zero in
  83.         kolor% the return VARIABLE.  Any non zero value returned in q% means
  84.         the point is turned on. 
  85.  
  86.  
  87.  
  88. You can run a short demo program that demonstrated the routines by typing
  89. to the command prompt
  90.  
  91. C:> QB TEST /L QB-UTILS.EXE
  92.  
  93. after Quick Basic loads type a control R ( ^R ) to start the demo
  94.  
  95.  
  96. If you have any suggestions or enhancements you would like to see leave me a 
  97. note on Gene Plantz's BBS, Hoffman Estates, Ill. Good luck  
  98.                                         
  99.  
  100.                                                 Mark Victor
  101.  
  102.